CreateLinkSource

Inside Macintosh: OpenDoc Class Reference /: Part 1 - Classes and Methods / ODDraft

CreateLinkSource
The CreateLinkSource method creates a new link-source object in this draft.
ODLinkSource CreateLinkSource (in ODPart part);
part
A reference to the part containing the source content of the link.
return value
A reference to the newly created link-source object.

DISCUSSION
You typically call this method from your part's CreateLink method when creating the source of a link. You can call this method only if this draft's current permissions provide write access.
Because all link-source objects have a unique link object companion, this method fails if the companion object cannot be created.
This method initializes the reference count of the returned link-source object. When you have finished using that link-source object, you should call its Release method.
If this method executes successfully, it marks this draft as dirty.

EXCEPTIONS

kODErrCannotCreateLink
Cannot create the link-source object or the companion link object.

SEE ALSO
The ODDraft::AcquireLinkSource method (page 155).
The ODPart::CreateLink method (page 492).
The ODLinkSource class (page 371).
"Creating a Link at the Source" on page 386 in OpenDoc Programmer's Guide.
Table 11-1 on page 466 in OpenDoc Programmer's Guide.